home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Panorama / Panorama - Disk 19D (1987-07-22)(Pacific North-West Amigas Club)[WB].zip / Panorama - Disk 19D (1987-07-22)(Pacific North-West Amigas Club)[WB].adf / PMBBUC1.0 / pmbbuc.doc < prev   
Text File  |  1987-07-16  |  5KB  |  141 lines
  1. NAME
  2.  
  3.     pmbbuc -- recovers system time after warm boots
  4.  
  5.  
  6. VERSION
  7.  
  8.     1.0 released 7/14/87.
  9.  
  10.     Copyright (C) 1987 by Kenneth Chiu.  Permission is hereby granted to
  11.     use this program in any way you see fit, as long as the copyright
  12.     notice is not removed.
  13.  
  14.  
  15. SYNOPSIS
  16.  
  17.     pmbbuc [-v] [-r] [-s <seconds>] [-p <priority>] [-h <handler>]
  18.  
  19.  
  20. DESCRIPTION
  21.  
  22.     Pmbbuc attempts to recover the system time by searching for a tag in
  23.     memory.  This tag will only be found if pmbbuc has been run
  24.     previously, and the Amiga has not been cold-started since then.
  25.  
  26.     To use pmbbuc, execute it from your Startup-Sequence.  It is not
  27.     critical where in your Startup-Sequence pmbbuc is run, but for best
  28.     results, you should execute it first.  This is because it took some
  29.     amount of time to reboot, and pmbbuc adds an increment to the time it
  30.     finds in RAM to account for it.  The more consistent your boot time,
  31.     the better the accuracy, and placing it first usually works best.
  32.  
  33.     When pmbbuc is run, it searches for a tag in RAM.  If it finds it, it
  34.     assumes this is the time since the reboot, and it will set the system
  35.     time to this plus an increment.  If it doesn't find a tag, it returns
  36.     WARN, so you can use an If command to detect this.
  37.  
  38.     After the search, a new tag is allocated, and a small daemon is
  39.     loaded to keep this tag current.
  40.  
  41.     The options are:
  42.  
  43.     -v        Be verbose.
  44.  
  45.     -r        Clear the memory of any old tags laying around. This
  46.               is necessary if you run pmbbuc, then reboot without
  47.               running pmbbuc, and then decide you want to use
  48.               pmbbuc.  -r will remove any old tags that may be left
  49.               from previous sessions.
  50.  
  51.     -s (seconds>   Add <seconds> to the time found in RAM.  <seconds>
  52.               will be about how long it takes from the time the
  53.               reboot starts to the moment pmbbuc is executed.  This
  54.               will depend on a number of factors, such as file
  55.               fragmentation.  This value should be  determined
  56.               empirically.  17 seems to work well for me, and is
  57.               the default.  The valid range is from 0 to 60.
  58.  
  59.     -p <priority>  Link the handler into the input handler chain at
  60.               priority <priority>.  Intuition is at 50.  A priority
  61.               of 100 seems to work fine, and is the default.
  62.               <priority> must be from -128 to 127 inclusive.
  63.  
  64.     -h <handler>   Specify a path for the handler.  The default is
  65.               l:pmbbuc-handler.  Avoid a filename and directory
  66.               combination that may allow you to execute it
  67.               accidentally, like c:hand.  This would most likely
  68.               crash the system.
  69.  
  70.  
  71. INSTALLATION
  72.  
  73.     Place pmbbuc in some directory along your search path.  Place
  74.     pmbbuc-handler in l: (usually sys:l or df0:l, etc.), unless the
  75.     -h option is used.  Execute pmbbuc somewhere in your startup-script
  76.     (preferrably first).  Adjust the values to work well on your system.
  77.  
  78.  
  79. EXAMPLES
  80.  
  81.     pmbbuc -s 30 -p 0
  82.  
  83.     Your system takes a long time to boot, so add 30 seconds instead of
  84.     18.  Also, you are very paranoid about my daemon having too much
  85.     power, so put it at priority 0.
  86.  
  87.     pmbbuc -v -h c:cd
  88.  
  89.     You like seeing a bunch of meaningless data printed to your screen.
  90.     This makes you feel like you know what is going on in your life.
  91.     Also, you like to play stupid jokes on your friends, because every
  92.     time they use your computer and type cd, the pmbbuc handler is run
  93.     instead, and your system crashes.
  94.  
  95.     pmbbuc
  96.  
  97.     You're just like me.  Exactly.  A clone.
  98.     Well, actually, maybe you just filezapped all my defaults.
  99.  
  100.  
  101. TECHNICAL NOTES
  102.  
  103.     The accuracy of this program depends on the input device sending out
  104.     timer events up to the moment of reboot.  Once the reboot starts, the
  105.     same sequence of events should happen every time.  Thus if you have a
  106.     disk in both drives during one boot, but only one drive during
  107.     another reboot, you may get some error.  Also, there may be some
  108.     conditions where the input device has stopped, but the reboot
  109.     sequence has not started yet.  This could cause more significant
  110.     errors.
  111.  
  112.     For this program to work, a region of memory must be found that is
  113.     not written to during reboot.  High memory seems to work best, and
  114.     pmbbuc starts at the highest memory address it finds.  People with
  115.     various system configurations may find that this doesn't work well.
  116.     But these people can probably afford battery-backed clocks anyway.
  117.  
  118.     Pmbbuc is very fat, but the handler and tag only use 136 bytes.
  119.  
  120.  
  121. FILES
  122.  
  123.     pmbbuc              the tag finder and handler loader
  124.     pmbbuc-handler      the input device handler
  125.     pmbbuc.doc          this file
  126.  
  127.  
  128. BUGS
  129.  
  130.     If the loading process fails, not all the memory is returned.
  131.  
  132.     Robustness may be lacking for people with expansion memory, and/or
  133.     expansion devices.
  134.  
  135.  
  136. AUTHOR
  137.  
  138.     Kenneth Chiu
  139.     2921 Bagley Drive
  140.     Kokomo, IN  46902
  141.